home *** CD-ROM | disk | FTP | other *** search
/ FishMarket 1.0 / FishMarket v1.0.iso / fishies / 301-325 / disk_319 / cnewssrc / cnews.orig.lzh / notebook / bdiffs next >
Text File  |  1989-06-27  |  3KB  |  172 lines
  1. .TL
  2. Differences between B 2.11 news and C news
  3. .AU
  4. Geoff Collyer
  5. .AI
  6. Department of Statistics
  7. University of Toronto
  8. .SH
  9. Introduction
  10. .PP
  11. This document attempts to describe the major
  12. differences between
  13. B 2.11 news
  14. and
  15. C news;
  16. it cannot pretend to be complete.
  17. Since the message format of both is the one described in
  18. ARPA Internet RFC 1036,
  19. the differences arise primarily in how the software is set up
  20. and administered.
  21. .PP
  22. C news
  23. was begun before
  24. B 2.11 news
  25. was released,
  26. and later updated to match the worthwhile changes in
  27. B 2.11 news.
  28. .SH
  29. Differences in files
  30. .PP
  31. .I Locking.
  32. C news
  33. locks are intended to be compatible with those of
  34. B 2.10 news.
  35. C news
  36. locks out
  37. .I expire
  38. and
  39. .I rnews
  40. by linking to the name
  41. .I /usr/lib/news/LOCK
  42. and repeating until successful;
  43. there is no time-out
  44. such as the one in
  45. B 2.10 news,
  46. so humans can lock the news system and
  47. perform surgery on it with confidence.
  48. B 2.11 news
  49. is believed to use more modern kernel locking facilities
  50. such as
  51. .I flock (2)
  52. and
  53. .I lockf (2).
  54. One important difference is that
  55. C news's
  56. locks will work across network file systems,
  57. modulo problems caused by lock removal in
  58. .I /etc/rc .
  59. .PP
  60. .I "Log files."
  61. C news's
  62. are terse.
  63. .PP
  64. .I "History file."
  65. C news
  66. uses an extended
  67. B 2.10 news
  68. format:
  69. the second field consists of two subfields
  70. separated by a tilde:
  71. time received as an integer (a
  72. .I time_t
  73. in fact),
  74. and
  75. the value of the
  76. .I Expires:
  77. header,
  78. "-" if none.
  79. B 2.11 news
  80. does not record the
  81. .I Expires:
  82. value and stores the time received in a peculiar variant of
  83. .I ctime (3)
  84. format,
  85. which cannot be parsed by
  86. .I getdate (3),
  87. to the annoyance of
  88. .I nntp .
  89. You must lock the news system with
  90. .I locknews
  91. before editing the history file.
  92. .PP
  93. .I "active file."
  94. C news
  95. will tolerate two,
  96. three,
  97. or
  98. four
  99. fields in the
  100. .I active
  101. file,
  102. and
  103. any number of digits in the article-number fields
  104. (hint: five is too few).
  105. C news
  106. also supports two new values for the fourth field:
  107. .B x ,
  108. meaning
  109. ``quietly discard articles for this group'',
  110. and
  111. .B = realgroup
  112. meaning
  113. ``file articles for this group under
  114. .I realgroup
  115. instead''.
  116. .B =
  117. is useful for coping with badly-run
  118. local newsgroups,
  119. often created from mailing lists.
  120. You must lock the news system with
  121. .I locknews
  122. before editing the active file.
  123. .PP
  124. .I "sys file."
  125. C news
  126. ignores blank lines and
  127. .B #
  128. comment lines in the
  129. .I sys
  130. file.
  131. Many obsolete flags draw fatal diagnostics,
  132. notably
  133. .B N ,
  134. the old,
  135. unbatched ihave/sendme flag.
  136. If the fourth field is a relative command name,
  137. .B /usr/lib/news/bin
  138. and
  139. .B /usr/lib/newsbin/relay
  140. will be searched before the standard search path.
  141. If the fourth field is a relative file name,
  142. .B /usr/spool/news/out.going
  143. will be prepended.
  144. The ihave/sendme kludges of B news
  145. have been expunged;
  146. one must say what one means,
  147. using three to five entries,
  148. typically.
  149. .SH
  150. Differences in behaviour
  151. .PP
  152. .I "Control messages."
  153. .I Checkgroups
  154. is non-destructive in C news;
  155. it merely mails its output to
  156. .B $NEWSMASTER
  157. (e.g.
  158. .B usenet ).
  159. The superfluous
  160. .I Supersedes:
  161. header is not honoured.
  162. .PP
  163. .I "Newsgroup aliases."
  164. C news
  165. does not implement newsgroup aliases,
  166. since we believe that header munging is to be avoided
  167. except under extreme duress.
  168. It is possible to file articles locally under different newsgroups
  169. by use of the active file
  170. .B =
  171. flag.
  172.